home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / associated.z / associated
Encoding:
Text File  |  1998-10-30  |  2.8 KB  |  67 lines
  1. ASSOCIATED(3I)                                         Last changed: 2-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      AASSSSOOCCIIAATTEEDD - Returns the pointer association status
  6.  
  7. SSYYNNOOPPSSIISS
  8.      AASSSSOOCCIIAATTEEDD (([PPOOIINNTTEERR==]_p_o_i_n_t_e_r [,,[TTAARRGGEETT==]_t_a_r_g_e_t]))
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, and IRIX systems
  12.  
  13. SSTTAANNDDAARRDDSS
  14.      Fortran 90
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The AASSSSOOCCIIAATTEEDD intrinsic function returns the association status of
  18.      its pointer argument or indicates the pointer is associated with the
  19.      target.  It accepts the following arguments:
  20.  
  21.      _p_o_i_n_t_e_r   Must be a pointer and can be of any type.  Its pointer
  22.                association status must not be undefined.
  23.  
  24.      _t_a_r_g_e_t    Must be a pointer or target.  If it is a pointer, its
  25.                pointer association status must not be undefined.
  26.  
  27.      AASSSSOOCCIIAATTEEDD is an inquiry function.  The name of this intrinsic cannot
  28.      be passed as an argument.
  29.  
  30. RREETTUURRNN VVAALLUUEESS
  31.      The result is of type default logical.
  32.  
  33.      If _t_a_r_g_e_t is absent, the result is true if _p_o_i_n_t_e_r is currently
  34.      associated with a target and false if it is not.
  35.  
  36.      If _t_a_r_g_e_t is present and is a target, the result is true if _p_o_i_n_t_e_r is
  37.      currently associated with _t_a_r_g_e_t and false if it is not.
  38.  
  39.      If _t_a_r_g_e_t is present and is a pointer, the result is true if both
  40.      _p_o_i_n_t_e_r and _t_a_r_g_e_t are currently associated with the same target, and
  41.      is false otherwise.
  42.  
  43.      If either _p_o_i_n_t_e_r or _t_a_r_g_e_t is disassociated, the result is false.
  44.  
  45.      If _p_o_i_n_t_e_r and _t_a_r_g_e_t are both dummy arguments, the result is
  46.      undefined.
  47.  
  48. EEXXAAMMPPLLEESS
  49.      Example 1:  AASSSSOOCCIIAATTEEDD ((CCUURRRREENNTT,, HHEEAADD)) is true if CCUURRRREENNTT points to
  50.      the target HHEEAADD.
  51.  
  52.      Example 2:  Consider the following statement:
  53.  
  54.           AA__PPAARRTT ==>> AA ((::NN))
  55.  
  56.      After the preceding statement is executed, the statement AASSSSOOCCIIAATTEEDD
  57.      ((AA__PPAARRTT,, AA)) is true if NN is equal to UUBBOOUUNNDD((AA,, DDIIMM == 11)).
  58.  
  59.      Example 3:  After the execution of the following statements,
  60.      AASSSSOOCCIIAATTEEDD((CCUURR,, TTOOPP)) is false:
  61.  
  62.           NULLIFY ((CCUURR));;  NNUULLLLIIFFYY ((TTOOPP))
  63.  
  64. SSEEEE AALLSSOO
  65.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  66.      printed version of this man page.
  67.